home *** CD-ROM | disk | FTP | other *** search
/ NeXT Education Software Sampler 1992 Fall / NeXT Education Software Sampler 1992 Fall.iso / READMEFiles / Briefcase.README < prev    next >
Text File  |  1992-08-29  |  4KB  |  52 lines

  1. /* Canon Information Systems is not responsible for anything anyone does with this   */
  2. /* code, nor are they responsible for the correctness of this code.  Basically, this */
  3. /* has very little to do with the company I work for, and you can't blame them.      */
  4.  
  5. /* You are welcome to do as you would with this file under the following conditions. */
  6. /* First, I accept no blame for anything that goes wrong no matter how you use it,   */
  7. /* no matter how catastrophic, not even if it stems from a bug in my code.             */
  8. /* Second, please keep my notices on it when/if you distribute it.                     */
  9. /* Third, if you discover any bugs or have any comments, PLEASE TELL ME!  Code won't */
  10. /* get better without people picking it apart and giving the writer feedback.        */
  11. /* Fourth, if you modify it, please keep a notice that your version is based on mine */
  12. /* in the source files (and keep the notice that mine is based on four other pieces  */
  13. /* of code :<).  Thanks, and have fun.  - Subrata Sircar, ssircar@canon.com             */
  14.  
  15. Briefcase - a utility for opening multiple files/documents in different applications.
  16.  
  17. Version 1.0 fixes several minor bugs.  The Localization code needed the launchDirectory before the app delegate was instantiated.  Several other strings were localized.  I also added an "Easter Egg".
  18.  
  19. This program has two reasons for existence.  First, I wanted to generalize the
  20. multiple-document architecture embodied in Draw for use in my own applications.
  21. To do that, I decided to implement an application delegate superclass, which can
  22. readily be added to existing applications and connected in IB.  There is also a
  23. Document superclass, which implements the things I thought documents should keep
  24. track of (dirty, empty, file management, etc.)  To demonstrate that these classes
  25. are at least somewhat subclassable (and hence of value to others), I wrote
  26. Briefcase with this paradigm.  This package also includes a Preferences Delegate
  27. object, which manages a preferences panel; support for localization; and other
  28. goodies.
  29.  
  30. The second reason is that I often find myself working with the same collection of
  31. three documents, one word processor, one graphics and one spreadsheet document.  In
  32. this case, I don't need feedback about the documents launching; I just want to launch
  33. them all at once, with one key click.  Briefcase will allow you to specify files to be
  34. launched in one of three ways:  either by typing in the absolute path (ended by a return)
  35. using the Open panel, or by dragging and dropping the file(s) on the app's icon.  These
  36. files are displayed in a window which the user can edit.  When you save the document,
  37. Briefcase writes a quick C program to open the files, compiles it and drops it in the
  38. directory you specified.  (There will also be a <file>.bc document in that directory.
  39. Please avoid stepping on this - it is necessary for now.)  Running this program launches
  40. the files.  Now, you can create mini-programs for use in the dock, or in your directory
  41. which will launch multiple files in different directories in different applications
  42. at once.
  43.  
  44. Full Documentation (such as it is) can be found in the Help panel.  Once again, please
  45. forward comments to me - that's the only thing I'm asking in return for releasing the
  46. code.  I want to learn how to do things right, and I'm asking you to help me.  Thanks!
  47.  
  48. Oh yeah.  Just type 'make' at a prompt - it has the standard NeXT IB-generated Makefile.  It should compile with no warnings.  A prebuilt version is also provided.
  49.  
  50. - Subrata Sircar        ssircar@canon.com
  51.  
  52.